Auto-Remove Hole Punches

Automatically detects and removes dark circular hole punch marks on 1-bit image created during scanning when a black background scanner is used. No input parameter is required to control the process.

→

The uncompressed image to be processed must reside in the Get Queue prior to REQ_EXEC. Typically, the image will be fully contained in the Get Queue, but that is not a requirement. The output image will be placed into the Put Queue during REQ_EXEC.

This subcode differs from the Remove Blobs or Hole Punches (15) in that it is specifically designed to remove nothing but circular hole punches on the image while the latter requires user input to manually specify the size and location of hole punches. It also considers other factors, like circularity, black pixel ratio, and group properties of hole punches to make it more accurate.

Subcode is set to SF_SUBCODE_AUTO_REMOVE_HOLEPUNCHES (53).
No other parameters need to be set.

In addition to placing an output image into the Put Queue, this operation stores some output information into the PIC_PARM structure in the following locations.

CountOfFeaturesDetected is set, during REQ_EXEC, to the number of hole punches detected.
Confidence is set, during REQ_EXEC, to from 0 to 100 with 0 indicating that the returned result is probably not correct and 100 indicating that the returned result is almost certainly correct.
PunchLocation is set, during REQ_EXEC, to the list of detected hole punch bounding boxes. Each area is identified by its X coordinate, Y Coordinate, width, and height.
PunchConfidence is set, during REQ_EXEC, to the list of each detected hole punch's confidence. Each confidence value indicates how likely the hole punch is a real punch.
OutputStride is set, during REQ_INIT and REQ_EXEC, to the image line width in bytes including padding at the end of the line.
BiOut is set, during REQ_INIT and REQ_EXEC, to the attributes of the output image. Since this operation does not adjust the size of the image, BiOut will be set to a copy of the Head structure within PIC_PARM.